Skip to content

Improve instructions in CONTRIBUTING.md#2871

Open
dplyukhin wants to merge 1 commit intomasterfrom
dplyukhin/improve-contributing-guide
Open

Improve instructions in CONTRIBUTING.md#2871
dplyukhin wants to merge 1 commit intomasterfrom
dplyukhin/improve-contributing-guide

Conversation

@dplyukhin
Copy link
Copy Markdown

What was changed

Updated CONTRIBUTING.md and mise.toml, adding missing gradle toolchain dependencies.

Also fixed test instructions in CONTRIBUTING.md, which incorrectly state that a temporal server needs to be running during tests. Explained how to run the tests that do require a temporal server.

Why?

The project wouldn't build when following the old instructions. The instructions were also omitting some tests that require a temporal server to be running.

Add missing gradle toolchain dependencies to the list of Java version
requirements, both in CONTRIBUTING.md and mise.toml.

Fix test instructions in CONTRIBUTING.md, which incorrectly state that a
temporal server needs to be running during tests. Explain how to run the
tests that *do* require a temporal server.
@dplyukhin dplyukhin requested a review from a team as a code owner May 5, 2026 21:59
@CLAassistant
Copy link
Copy Markdown

CLAassistant commented May 5, 2026

CLA assistant check
All committers have signed the CLA.

@dplyukhin dplyukhin added the documentation Improvements or additions to documentation label May 5, 2026
Comment thread CONTRIBUTING.md
## Testing

Run a local temporal server with the [temporal CLI](https://docs.temporal.io/cli#installation):
Some tests assume you have the temporal server running, and others don't. By default, Gradle only runs the tests that don't require a server:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This paragraph isn't accurate, or is at least misleading. The tests by default use the built in test server, and you can optionally run against a real server instead

Comment thread CONTRIBUTING.md

```bash
./gradlew build
USE_DOCKER_SERVICE=true ./gradlew test
Copy link
Copy Markdown
Contributor

@Quinn-With-Two-Ns Quinn-With-Two-Ns May 7, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The environment variable name predate being able to start the Temporal server with the CLI, so docker was the main way to run the Temporal server locally, but we should probably update it now (doesn't need to be in this PR just adding some historical context)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants